home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / pidentd / pidentd-2.6.1 / INSTALL < prev    next >
Text File  |  1995-07-30  |  4KB  |  87 lines
  1. To build the "in.identd" daemon, do the following steps:
  2.  
  3. 1. Type "make" and see if your machine is among one of those
  4.    listed. If so, goto step 5.
  5.  
  6. 2. Copy the entry for "other" in the top-level Makefile into a
  7.    new one and edit it for your system.
  8.  
  9. 3. If your machine/OS has the "KVM" routines (you can find out by
  10.    typing "man kvm_open"), then add "-lkvm" (or whatever it's called
  11.    on your system) to your newly created entry.
  12.  
  13. 4. Edit the file "paths.h" to contain valid definitions for
  14.    your system. 
  15.  
  16. 5. Type "make <systype>", where <systype> is one from the list
  17.    displayed when you type "make" without arguments. Then watch it
  18.    build nicely (hopefully).
  19.  
  20. 6. As "root", type "make install". This will copy the executable
  21.    daemon "in.identd" into the destination directory as specified in
  22.    the Makefile (normally /usr/local/sbin) and the man page into the
  23.    specified man directory (normally /usr/local/man/man8).
  24.  
  25.    Please make sure that it is executable for the user you specify below
  26.    in step 8! Otherwise it will fail for obvious reasons.
  27.  
  28. 7. Edit /etc/services to contain a line "ident 113/tcp auth tap".
  29.  
  30.    If your system is running SunOS, or some other system with NIS (or YP)
  31.    then make sure you edit the /etc/services file on the machine running
  32.    the _master_ YP server, and then cd to your YP directory and type "make".
  33.    (On SunOS 4.*: "cd /var/yp; make").
  34.  
  35. 8. Edit the file /etc/inetd.conf to contain a line (replace "sys" with
  36.    a user with enough rights to READ the kernel memory. Under SunOS 4.*,
  37.    user "sys" is a member of the "kmem" group and is a good choice. If
  38.    you have no "kmem" or "sys" user, then I suggest you create one and
  39.    assign read rights for the group "kmem" to the /vmunix and /dev/kmem
  40.    and /dev/mem "files" - you might also have to modify the group id of
  41.    other programs that read the kernel, like "netstat", "ps" and more):
  42.  
  43.      ident     stream  tcp  nowait  sys   /usr/etc/in.identd in.identd
  44.  
  45.    If you're running A/UX 2.0*, inetd reads from /etc/servers. This contains
  46.    an archaic(?) form of the above:
  47.  
  48.     ident    tcp    /usr/etc/in.identd
  49.  
  50.    Hint: Some unixes requires the daemon to run as user "root" even though
  51.    it is setgid to a group that can read /dev/kmem.
  52.  
  53. 9. Restart the "inetd" daemon. (Can normally be done with a "SIGHUP" signal).
  54.  
  55. 10. Test the daemon by TELNET:ing to "130.236.254.1" port 114 and verify 
  56.     that the information displayed is correct. (It should give your user 
  57.     name, "UNIX" as operating system and no character set). The program on
  58.     port 114 will connect to your newly installed daemon and try to retrieve
  59.     the identity of you.
  60.  
  61.     Another way to test the daemon is by TELNET:ing to "localhost" port
  62.     113 and then escape to the command level temporarily (normally you can
  63.     do this by keying "Ctrl-] z". Then type "netstat -n | egrep 113" and 
  64.     remember the other port number that you will see. Now return to your
  65.     TELNET session and enter "4711 , 113", where you replace 4711 with the
  66.     number you got from "netstat". If things work out ok you should see a
  67.     response like:
  68.  
  69.        4711 , 113 : USERID : UNIX : foobar
  70.  
  71.     Where "foobar" should be your user name. If it doesn't work then
  72.     please send me a bug report at <pen@lysator.liu.se>.
  73.  
  74.     You may also find the "itest" program useful to verify that the
  75.     internal kernel-accessing routines in the Ident daemon is working
  76.     correctly.
  77.  
  78.     Use it like this:
  79.  
  80.     netstat -n | grep ESTAB | ./itest
  81.  
  82.     And the output should be a list of username and the TCP connections
  83.     they own. This program must be run as root (or be setgid just like
  84.     the pidentd daemon).
  85.  
  86. 11. Else all is done and your server should be ready for real world usage.
  87.